Centralizes Copilot instruction sync logic in Cratis/Workflows so all repos delegate here rather than each maintaining their own copy.

Reusable workflows

• sync-copilot-instructions.yml (workflow_call) — clones a source_repository, copies .github/copilot-instructions.md, .github/instructions/, and .github/agents/, then opens a PR in the calling repo. Input validated against injection-safe regex and must belong to the Cratis organization.
• propagate-copilot-instructions.yml (workflow_call) — lists all Cratis repos and fires sync-copilot-instructions.yml in each (skipping the caller to prevent loops). Uses a job-level if: github.repository_owner == 'Cratis' guard to silently skip runs from outside the org.

Bootstrap

• bootstrap-copilot-sync.yml (workflow_dispatch) — one-shot workflow that opens PRs in every non-archived Cratis repo adding two thin wrappers:

# sync wrapper (workflow_dispatch)
jobs:
  sync:
    uses: Cratis/Workflows/.github/workflows/sync-copilot-instructions.yml@main
    with:
      source_repository: ${{ inputs.source_repository }}
    secrets: inherit

# propagate wrapper (push to main on copilot paths)
jobs:
  propagate:
    uses: Cratis/Workflows/.github/workflows/propagate-copilot-instructions.yml@main
    secrets: inherit

Idempotent — skips repos where the PR branch already exists. Requires PAT_DOCUMENTATION secret with repo scope.

Documentation

README.md includes a getting-started section for Cratis repositories, a Mermaid sequence diagram for the end-to-end propagation flow, a Mermaid flowchart for the sync workflow internals, and a per-workflow reference table.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.